Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 5 - Menu Manager Reference / Menu Manager Functions

Manipulating and Accessing Menu Item Characteristics /

GetMenuItemIconHandle

NEW WITH THE APPEARANCE MANAGER

Gets a handle to a menu item's icon.

pascal OSErr GetMenuItemIconHandle (
                     MenuHandle inMenu,
                     SInt16 inItem,
                     MenuIconType outIconType,
                     Handle* outIconHandle);

inMenu

The handle to the menu structure of the menu item with an icon for which you wish to get the handle.

inItem

An integer representing the item number of the menu item with an icon for which you wish to get the handle.

outIconType

On output, a menu item's icon type. If the menu item has no icon attached, this parameter will contain kMenuNoIcon.

outIconHandle

On output, a pointer to a handle to the icon that is attached to your menu item; see "Menu Icon Handle Constants". If the menu item has no icon suite attached, this parameter contains nil.

function result

A result code; see "Result Codes".

DISCUSSION

The GetMenuItemIconHandle function gets the icon handle and type of icon of the specified menu item. If you wish to get a resource-based menu item icon, call GetItemIcon.

SEE ALSO

"Appearance Manager Gestalt Selector Constants".

SetMenuItemIconHandle.